home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr37 / ripsk111.zip / RSKETCH.DOC < prev    next >
Text File  |  1995-03-07  |  20KB  |  477 lines
  1.  
  2.                                    RIP Sketch
  3.  
  4.                                   Version 1.11
  5.  
  6.                                    Shareware
  7.  
  8.                            Copyright 1995 Wayne Thomas
  9.  
  10.  
  11.  
  12. Introduction
  13. ============
  14.  
  15.  RIP Sketch is a simple, easy to use drawing program that generates RIPscrip
  16.  files for use with online communications.  It is designed to generate very
  17.  efficient files to save on transfer time.  It will also reduce the size of
  18.  most existing RIP files my shrinking and removing unneeded commands.  It
  19.  supports all the basic RIP commands and nearly all of the more complicated
  20.  ones, making it very compatible with the RIPscrip 1.54 standard.  It supports
  21.  buttons and mouse regions, allowing you to create quality RIP menus and 
  22.  screens.
  23.  
  24.  RIP Sketch is also a command line viewer, with the /V command line switch,
  25.  to view one or more RIPs from the command line.
  26.  
  27.  
  28.  
  29. Requirements
  30. ============
  31.  
  32.  EGA with 256Kb video memory or better graphics.
  33.  Microsoft mouse & compatibles.   (not required for viewing)
  34.  
  35.  Recommended at least 450Kb free memory.
  36.  Also supports the Adlib sound card & compatibles.
  37.  
  38.  
  39.  
  40. Files
  41. =====
  42.  
  43.  The following files are part of the RIP Sketch package:
  44.  
  45.  RSKETCH.EXE   Main program
  46.  DISPICON.EXE  Program to display icon files
  47.  RSKETCH.DOC   This file
  48.  REGISTER.DOC  Information on how to register
  49.  HISTORY.111   Revision history information
  50.  FILE_ID.DIZ   Description of this package
  51.  
  52.  RIP Sketch will generate more files:
  53.  
  54.  RSKETCH.CFG   Configuration file
  55.  RSKETCH.PAT   Custom patterns file
  56.  RSKETCH.REG   Registration file (if registered)
  57.  
  58.  
  59.  
  60. Quick Start
  61. ===========
  62.  
  63.  Copy all the files to a subdirectory on your hard drive, and run RSKETCH.EXE.
  64.  You will be asked to enter the name of the directory where you keep all your
  65.  icons.  (Example: c:\ripterm\icons)  You will then be asked for the maximum
  66.  line length for your saved RIP files.  (Range 39-200, the default is 79.) 
  67.  Then RIP Sketch will start up.  Use the right mouse button to toggle from 
  68.  the menu to the drawing screen.  There is a help bar at the top of the screen 
  69.  to tell you what every button does when you move the mouse cursor to it.
  70.  Please keep an eye on this help bar, because at times it will ask you for 
  71.  information that you will need to type in.  Also, pressing the F1 key will
  72.  give you additional help for keyboard options.
  73.  
  74.  Note: RIP Sketch can be executed from another drive or from the path.  It 
  75.  will know where to find the configuration file and the icon files.
  76.  
  77.  
  78.  
  79. Command line options
  80. ====================
  81.  
  82.   /Q              Quiet mode.  This will disable sound card support.
  83.   
  84.   /V[delay] file  Viewer mode.  This option allows RIP Sketch to be a command
  85.                   line viewer.  The delay ranges from 1-9 and is optional.  If
  86.                   a wildcard is used, the file name will be displayed at the
  87.                   bottom of the screen.  The default extension is .RIP
  88.  
  89.   /C              Compatibility mode.  Use this option if other RIP viewers 
  90.                   that you are using can not display the RIP files generated 
  91.                   by RIP Sketch.  Not using this switch will result in a more
  92.                   efficient and smaller RIP files.
  93.   
  94.   /NT             No text mode.  No text will be displayed in the text window 
  95.                   with this option.  Without this option, any non-RIP text
  96.                   will be displayed in the text window, if defined.
  97.  
  98.   /NO             No optimization.  This option tells RIP Sketch not to 
  99.                   automatically optimize the RIP scene.  Use this option if 
  100.                   you do not want commands removed, or editing a file based on
  101.                   a RIP standard after version 1.54.
  102.  
  103.   /M              Mouse compatibility mode.  Use this option if the mouse does 
  104.                   not work properly, or if the mouse pointer is not visible.  
  105.                   If you want a plain cross-hair mouse pointer, use this 
  106.                   option.
  107.  
  108.   /L              Left hand mouse mode.  This command line option will swap 
  109.                   the functions of the left and right mouse buttons.
  110.  
  111.   /Z              Turn on the Zoom option when starting RIP Sketch.
  112.  
  113.   /S              Turn on the Show X,Y option when starting RIP Sketch.
  114.  
  115.   /F              Flood fill mode.  This command allows you to add flood fills
  116.                   to the scene.
  117.  
  118.  Note:  A dash, '-' can be used instead of a slash, '/' and the parameters are 
  119.  not case sensitive.  If you want to always use some of the above functions,
  120.  then it is recommended to create a batch file with those desired command line
  121.  switches.
  122.  
  123.  
  124.  
  125. Disclaimer
  126. ==========
  127.  
  128.  No warranty is expressed or implied.  Use at your own risk.  The author will
  129.  not be held responsible for any damages from the use of this product.  It has
  130.  been tested on many systems without problems, but it has not or could not
  131.  have been tested on every type of system.
  132.  
  133.  
  134.  
  135. Options
  136. =======
  137.  
  138.  
  139.  Main commands
  140.  -------------
  141.  
  142.   Load:  Load a .RIP file from disk.  This button brings up a file menu that 
  143.        allows you to load RIP files.
  144.  
  145.   Save:  Save the picture as a .RIP file.  This button brings up a file menu
  146.        that allows you to save your RIP file.  There are three screen 
  147.        preparation options that allow you to clear the text window, clear the
  148.        graphics window and to remove all mouse fields.  Selecting all three
  149.        (the default) will cause RIP Sketch to use a reset windows command
  150.        instead.
  151.  
  152.   Edit:  Find, display and remove previously drawn objects.  This button will
  153.        bring up a sub menu that shows the data for the RIP commands and their
  154.        functions.  It defaults to the last function, with buttons to go the
  155.        top or the bottom command, and to step forward or backward by one 
  156.        command.  The view button will show the RIP up to that point in the RIP
  157.        scene, with the last command delayed by one half second.  The delete
  158.        button will remove the command from the RIP scene.
  159.  
  160.   Undo:  Remove all the objects that were made since you last toggled to the
  161.        menu screen, if any.
  162.  
  163.   View:  View contents of the clipboard, if any.
  164.  
  165.   Show:  Show invisible regions.  These are the mouse regions, the text viewport
  166.        and the graphic viewport.
  167.  
  168.   New:   Clear the RIP scene and start over.
  169.  
  170.   Quit:  Exit RIP Sketch and return to DOS.  Pressing Esc will also exit the
  171.        program.
  172.  
  173.   Register:  Enter registration code to register RIP Sketch.  This removes all
  174.        shareware notices and delays.
  175.  
  176.   Show X,Y:  This will display the mouse coordinates while in the drawing
  177.        screen.
  178.  
  179.   Zoom:  This will show an enlarged area from around the mouse pointer while 
  180.        in the drawing screen.
  181.  
  182.  
  183.  Draw options
  184.  ------------
  185.  
  186.   Draw color: Change the draw color to one of sixteen colors.
  187.  
  188.   Change palette:  Change the palette of the currently selected draw color.
  189.        Please note:  When clicking back to draw mode, all the palette changes
  190.        are added to the RIP scene.  If you wanted to make a color fade in or
  191.        out, you would have to click back to draw mode for every shade you
  192.        changed.
  193.  
  194.   Write mode:  Toggle the write mode from COPY to XOR (exclusive or).  In XOR
  195.        mode, the object's lines are XORed with the screen.  If you draw the
  196.        same lines over each other in XOR mode, it will make them disappear.
  197.  
  198.   Font:  Change the current font style.  There are eleven fonts.
  199.  
  200.   Font size:  Change the font size.  There are ten font sizes.
  201.  
  202.   Font direction:  Change the font direction.  There are two directions, from
  203.        left to right and from bottom to top.
  204.  
  205.   Line style:  Change the current line style.  There are five line styles
  206.        available.  The last one is the user defined line style.
  207.  
  208.   Line thickness:  Toggle the line thickness between thin and thick.
  209.  
  210.   Line pattern:  Create a user defined line pattern.
  211.  
  212.  
  213.  Fill options
  214.  ------------
  215.  
  216.   Fill style:  Change the current fill style.  There are thirteen fill styles
  217.        available.  The last one is the user defined fill pattern.  Please note
  218.        that the first (fill with background color) does not work with all
  219.        objects.
  220.  
  221.   User fill:  Set the pattern for the user fill pattern.
  222.  
  223.   Fill color:  Change the fill color to one of the sixteen colors.
  224.   
  225.   Load:  Loads one of the user fill patterns.
  226.  
  227.   Save:  Saves the user fill pattern to disk.
  228.  
  229.  
  230.  Button options
  231.  --------------
  232.    
  233.   Chisel:  Display chisel special effect on the button.  This gives the 
  234.        impression of an indented gutter just on the inside of the button's
  235.        border.
  236.  
  237.   Bevel:  Display bevel special effect around the button.  This makes it appear
  238.        to emerge from the picture.
  239.  
  240.   Sunken:  Display sunken special effect on the button.  This places a thin
  241.        inverted bevel on the inside edge of the button, giving it a sunken
  242.        appearance.
  243.  
  244.   Mouse:  Make the button a clickable mouse region.  Without this option set, 
  245.        the button would be just for looks.
  246.  
  247.   Stamp:  Auto-stamp the button image onto the clipboard.  This will also cause
  248.        the button settings to change after the button is drawn.
  249.  
  250.   Explode:  Zoom out when the button is clicked.  This will only work if the
  251.        button is a mouse button.
  252.  
  253.   Reset:  Reset screen after the button is clicked.  This will only work if the
  254.        button is a mouse button.
  255.  
  256.   Invertible:  Invert the button when clicked.  This will only work if the
  257.        button is a mouse button.
  258.  
  259.   Recessed:  Display recessed special effect around the button.  This places a
  260.        one pixel wide bevel around the entire button image.  It is not
  261.        considered part of the button.
  262.  
  263.   Dropshadow:  Dropshadow the button label.  This will make the label appear to
  264.        have a shadow on the button.
  265.  
  266.   Underline:  Underline the hot-key in the button label.  This will only work
  267.        if the button is a mouse button.
  268.  
  269.   Highlight:  Highlight the hot-key character in the button label.  This will
  270.        only work if the button is a mouse button.
  271.  
  272.   Button type:  Select type of button, Plain, Icon or Clipboard.  The clipboard
  273.        button will only be available if there is a clipboard.
  274.  
  275.   Bevel width:  Select the size of the button bevel.
  276.  
  277.   Orientation:  Select the button label orientation.  The label can be on the
  278.        button, above, below, to the left or to the right of it.
  279.  
  280.   Color boxes:  The top four buttons select the button feature colors, while
  281.        the bottom three select the text label colors.
  282.  
  283.  
  284.  Draw commands
  285.  -------------
  286.  
  287.   Draw lines:  Uses line pattern and thickness, draw color and write mode.
  288.        Point to where you want the line to start and press the left mouse
  289.        button and hold it down to the point where you want the line to end.
  290.  
  291.   Draw connected lines:  Uses the draw color, line pattern, line thickness and
  292.        write mode.  Point to where you want the first line to start, press the
  293.        left mouse button and let go, move to where you want the first line to
  294.        end and the second line to begin.  Press the right mouse button to stop
  295.        drawing lines.
  296.  
  297.   Draw rectangles:  Uses the draw color, line pattern, line thickness and write
  298.        mode.  Point to where you want a corner of the box to be and press the
  299.        left mouse button.  Hold it down and move the mouse to where you want the
  300.        diagonally opposite corner to be and release the button.
  301.  
  302.   Draw filled rectangles:  Uses the fill pattern and color.  Works the same way
  303.        as rectangles above, except it draws solid bars.
  304.  
  305.   Draw polygons:  Uses the draw color, line pattern, line thickness and write
  306.        mode.  Works the same way as connected lines above, except that when
  307.        pressing the right mouse button, the first and last line is connected.
  308.  
  309.   Draw filled polygons:  Uses the draw color, line pattern and thickness, write
  310.        mode, fill pattern and color.  Works the same way as polygons above,
  311.        except that they are filled with the current draw color and pattern.
  312.  
  313.   Draw ovals:  Uses the draw color and line thickness.  Point to where you want
  314.        the center of the oval, hold down the left mouse button and move the
  315.        mouse to create the desired oval size and shape.
  316.  
  317.   Draw filled ovals:  Uses the draw color, line thickness, fill pattern and
  318.        color.  Works the same way as ovals above, except that they are filled
  319.        with the current draw color and pattern.
  320.  
  321.   Draw circles:  Uses the draw color and line thickness.  Works the same way
  322.        as ovals above.
  323.  
  324.   Draw filled circles:  Uses the draw color, line thickness, fill pattern and
  325.        color.  Works the same way as filled ovals above.
  326.  
  327.   Draw circular arcs:  Uses the draw color and line thickness.  First, draw a
  328.        circle, then after releasing the left mouse button, choose the start
  329.        angle for the arc, then press the left mouse button.  Next, choose the
  330.        ending angle for the arc.  The arc is drawn counter clockwise.
  331.  
  332.   Draw circular pie slices:  Uses the draw color, line thickness, pattern
  333.        fill color and pattern.  Works the same way as circular arcs above,
  334.        except that it is filled with the fill color and pattern to make a pie
  335.        slice.  It will be split from the right side.  (No start and ending
  336.        angle).
  337.  
  338.   Draw oval arcs:  Uses the draw color and line thickness.  Works the same way
  339.        as circular arcs above.
  340.  
  341.   Draw oval pie slices:  Uses the draw color, line thickness and pattern, fill
  342.        color and pattern.   Works the same way as circular pie slices above.
  343.  
  344.   Draw single dots:  Uses the draw color.  When the left mouse button is
  345.        pressed, a single pixel will appear in the center of the box.
  346.  
  347.   Draw smooth curves:  Uses the draw color, line thickness, line pattern and
  348.        the write mode.  First draw the curve like a line, then four boxes will
  349.        appear on it.  By moving the mouse cursor inside the boxes and pressing
  350.        the left mouse button, you can move them to change the shape of the
  351.        curve.  The two middle boxes can be moved off the curve to make it
  352.        bend.  If the curve becomes obstructed by the boxes, press the space 
  353.        bar to temporarily hide them.  Press the right mouse button to draw the 
  354.        curve.  Curve smoothness is automatically adjusted for each curve.
  355.  
  356.   Display text:  Uses the font, font size and direction.  When clicking this
  357.        option, you are asked to enter what text you want to use.  A box will 
  358.        appear when the left mouse button is pressed.  You can move the box to 
  359.        where you want and let go of the button to put the text where the box 
  360.        is.
  361.  
  362.   Filled poly-bezier:  Uses the draw color, line pattern and thickness, write
  363.        mode, fill pattern and color.  Works the same way as filled polygons 
  364.        above, except that the space bar or the middle mouse button toggles the 
  365.        curve functions on and off.  This command is not available with the /F
  366.        command line option.
  367.  
  368.   Flood fill:  Uses the fill color and pattern.  The fill will start where
  369.        the mouse cursor is and fill up everything to the currently selected
  370.        draw color.  This command is only available with the /F command line
  371.        option.  This drawing command will not be processed by programs that
  372.        use RIPscrip 2.0 and later versions.
  373.  
  374.  
  375.  Area commands
  376.  -------------
  377.  
  378.   Graphic viewport:  This box defines the area in which all graphics are to be
  379.        displayed.  Pressing the right mouse button defaults it to the full
  380.        screen.
  381.  
  382.   Text viewport:  This box defines the area in which all text from the host is
  383.        to be displayed.  There are five screen resolutions to choose from.
  384.        The text can either wrap to the next line, or be chopped off at the end
  385.        of the line.
  386.  
  387.   Copy to clipboard:  This command takes an area of the screen and copies it
  388.        to the clipboard.
  389.  
  390.   Paste clipboard:   This command takes the clipboard and pastes it to the
  391.        screen.  There are five write modes to choose from.
  392.  
  393.   Load icon:  This command loads a icon from the disk and pastes it to the
  394.        screen.  There are five write modes to choose from.  It first searches
  395.        the directory where RIP Sketch was run for the icon file, then searches
  396.        the directory where you keep your icons.
  397.  
  398.   Save icon:  This command saves the clipboard as an icon.  It is saved in the
  399.        directory where RIP Sketch was run.  On the users terminal, it will also
  400.        be saved in an appropriate subdirectory.
  401.  
  402.   Mouse region:  This command creates a hot mouse region.  When the user clicks
  403.        the left mouse button while in this area, the text specified will be
  404.        transmitted to the host.  The area can be inverted when clicked.  The
  405.        text window and screen can be reset.  You can use a caret to represent
  406.        control codes.  For example, ^M will be a carriage return.
  407.  
  408.   Button:  This command will create a button using the current button settings.  
  409.        This command also uses the current font and font size.
  410.  
  411.   Import text:  This command will allow you to load text from a file and place
  412.        it on the screen in a rectangular area, using the current font and 
  413.        font size.
  414.  
  415.   Copy region:  This command copies a large (or small) area of the screen
  416.        either up or down very quickly, without using the clipboard.
  417.         
  418.           
  419.  Other commands
  420.  --------------
  421.  
  422.   Add sound:  This command will add one of six RIP sound effects to the 
  423.        current point in the RIP file.
  424.  
  425.  
  426.  
  427. Troubleshooting
  428. ===============
  429.  
  430.  There has been some problems reported with RIP Sketch and some mice.  The
  431.  problem may be corrected with the /M command line switch.  If this does not
  432.  cause RIP Sketch to work with your mouse, see if you can find an updated
  433.  mouse driver.  If your mouse is hardware compatible with a Microsoft mouse,
  434.  then try using the a new version of the Microsoft mouse driver.  If none of
  435.  the above works, then you may still use RIP Sketch as a RIP command line
  436.  viewer, because for viewing, it does not require or use a mouse.
  437.  
  438.  
  439.  
  440. Registration
  441. ============
  442.  
  443.  RIP Sketch is shareware.  Please support this product by filling out
  444.  REGISTER.DOC and mailing it with a check or money order for $15.
  445.  You will receive a registration code that will remove the registration
  446.  delays and messages.  This code will work for future versions of RIP
  447.  Sketch.
  448.  
  449.  
  450.  
  451. Contacting the author
  452. =====================
  453.  
  454.  I can be reached with a public message in the RIP conference in the following
  455.  nets: RIME, Intelec, ILink, FringeNet.  I can also be reached at the Brewster
  456.  BBS, (914) 279-2514.  The latest versions of RIP Sketch will be uploaded 
  457.  there as soon as they become available.  Although I haven't tried it yet, I
  458.  may be able to be contacted at wayne.thomas@lcc.com
  459.  
  460.  Also by the author:  Freeview, a freeware *.RIP file viewer.
  461.  
  462.  
  463.  
  464. Coming soon!
  465. ============
  466.  
  467.  - RIP 2.0 functions
  468.  - Object editor
  469.  - Icon editor
  470.  
  471.  
  472.  
  473. Trademarks
  474. ==========
  475.  
  476.  RIPscrip and RIPterm are trademarks of TeleGrafix Communications, Inc.
  477.